Herramienta de migración del navegador de UiPath

La herramienta de migración del navegador de UiPath es una herramienta independiente que convierte los flujos de trabajo usando un navegador de destino como Internet Explorer, Chrome, Edge o Firefox, haciendo que apunten a otro navegador, como Chrome, Edge o Firefox. Esta herramienta puede ser útil al migrar flujos de trabajo desde el navegador Internet Explorer heredado a los navegadores más nuevos, o simplemente cuando desee adaptar su flujo de trabajo para usar otro navegador.

Esta herramienta es compatible con cualquier archivo XAML generado con cualquier versión de Studio o UIAutomation.

Nota: Existen determinados tipos de selectores que no se pueden migrar automáticamente con el uso de esta herramienta. Por ejemplo, los selectores que comienzan con <wnd…, ya que estos identifican elementos de IU renderizados de manera diferente por IE en comparación con Edge/Chrome/Firefox. Estos selectores tienen que actualizarse manualmente.

Cómo funciona la herramienta de migración del navegador de UiPath

Para migrar flujos de trabajo de un Explorador a otro, hay una lista de aspectos que se hacen de la siguiente manera:

• Los selectores se migran actualizando su propiedad .
• La propiedad TipoDeExplorador de las actividades Explorador abierto y Adjuntar explorador se modifican en consecuencia.
• Cualquier actividad del Proceso Cancelar dirigida al Explorador de origen se actualiza para focalizarse al Navegador de destino.

• Los elementos de Repositorio de Objeto definidos en el Explorador de Origen se convierten para utilizar el navegador de destino.

  Nota: La herramienta de migración no tiene una tasa de éxito del 100%. Para acercarse a dicha tasa, se recomienda realizar la validación en los flujos de trabajo migrados.

Instalación de la herramienta de migración del navegador de UiPath

Primero, descarga la herramienta comprimida desde el Centro de recursos en el portal de Automation Cloud (el menú de ayuda > Descargas > Herramientas de UiPath > Herramienta de migración del navegador).

A continuación, descomprime el archivo en la carpeta que elijas.

Ejecutar el UiPath.ConversionTool.exe ejecutable abre la Herramienta de conversión UiPath.

Configurar la herramienta de migración del navegador de UiPath

La herramienta de migración del navegador de UiPath se puede configurar editando el archivo Settings.json presente en la carpeta de instalación.

Se pueden modificar los siguientes parámetros:

• - determina la carpeta de destino donde quieres migrar los archivos XAML.
• "SourceBrowser": "IE" . Especifica el explorador de origen. Las posibles opciones son. IE, Chrome, Edge, Firefox.
• "DestinationBrowser": "Chrome" - determina el explorador de destino. Las posibles opciones son Chrome, Edge, Firefox.
• "PreviewChanges": false - si se establece en true, los archivos originales no se modifican, solo se genera un cambio en el registro. Si se configura en false, las salidas se aplican a archivos de origen XAML.
• "ReplaceNullBrowserType": true BrowserType = nullBrowserType = targetBrowser- Si se establece en true, si se encuentra, el se actualiza a . Si se establece en false, estos casos se ignoran.
• "IncludeSubfolders": true- Si se establece en true, modifica todos los archivos XAML de carpeta y subcarpetas especificadas. Si se estabelce en false, modifica solo los archivos en la carpeta principal de destino.
• "CreateBackupFiles": true true.bak- Si se establece , crea archivos de copia de seguridad () antes de actualizar los originales. Los archivos de copia de seguridad se pueden encontrar en {SourceFolder}/.conversion_backup. Si se establece en false, no se crean archivos de copia de seguridad.
• "EnableLogging": true - Si se establece trueen , crea un archivo de registro. Si se establece en false, no se crean archivos de registros.

Uso de la herramienta de migración del navegador de UiPath

De la IU

Para utilizar la herramienta, debes primero proporcionar la ruta al flujo de trabajo al que quieres migrar en la sección Carpeta de proyecto.

Luego, selecciona el explorador con el que has creado la automatización en el menú desplegable del explorador de origen, y el explorador al que quieres migrar en el menú desplegable del Explorador de destino.

Importante: si tienes una automatización creada con Internet Explorer y quieres migrarla a Firefox, selecciona IE en el menú desplegable del navegador de origen y Firefox en el menú desplegable del navegador de destino .

El botón de previsualizar cambios ejecuta la herramienta en modo de cambios de previa. Este escanea todos los .xamlarchivos y produce los cambios que se aplicarían en el archivo de UiPath.ConversionTool_log.jsonregistro que se genera en la carpeta de destino. No se aplican cambios en el flujo de trabajo actual y no se crean archivos de copia de seguridad.

El botón de inicio realiza la migración en el flujo de trabajo específico, haciéndolo compatible con el explorador de tu elección.

Desde la línea de comandos

Para utilizar la herramienta de configuración configurada en el archivo Settings.json , ejecuta el comando {ConversionToolInstallationFolder}/UiPath.ConversionTool.exe settings.json

Claves de verificación de Post migración

Una vez utilizada, la herramienta de migración del navegador de UiPath crea un archivo de registro llamado UiPath.ConversionTool_log en la carpeta del proyecto. El archivo proporciona una descripción general del proceso en el parámetro "GlobalStatistics" y los detalles completos de actualización para cada archivo XAML en el parámetro "FileChanges/FileName/Statistics" .

Otros aspectos de la migración

Si planeas migrar las automatizaciones a Edge (Chromium), esto se puede hacer a partir de:

• Versión de Studio v19.10.5 y UiPath.UIAutomation.Activities v19.11.3
• Versión de Studio v20.4.1 y UiPath.UIAutomation.Activities v20.4.1

Si planeas ejecutar después de migrar en Edge Chromium con el modo Modo IE activado, este está disponible a partir de UiPath.UIAutomation.Activities v20.10 y superiores.

Ten en cuenta que ejecutar automatizaciones en Chrome, Edge o Firefox requiere que se instale la Extensión de UiPath adecuada.